KAFKA-19480: Recreate /migration when it has null value #20627
Merged
+74
−15
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
…er-security-migration tool
|
This is a reupload of #20128 as that one has the JDK8 build stuck for some reason (while it works locally). |
viktorsomogyi
added
ci-approved
do-not-merge
harmadasg
approved these changes
Oct 2, 2025
viktorsomogyi
added
kraft
and removed
do-not-merge
|
Since it builds here I'll merge this and close #20128. I reran the flaky tests locally and they pass. |
chia7712
reviewed
Oct 8, 2025
|
|
||
| <p>The new standalone controller in the example configuration above should be formatted using the <code>kafka-storage format --standalone</code>command.</p> | ||
|
|
||
| <p>Note: The migration can stall if the <a href="#zk_authz_migration">ZooKeeper Security Migration Tool</a> was previously executed (fixed from 3.9.2, see <a href="https://issues.apache.org/jira/browse/KAFKA-19480">KAFKA-19026</a> for more details). As a workaround, the malformed "/migration" node can be removed from ZooKeeper by running <code>delete /migration</code> with the <code>zookeeper-shell.sh</code> CLI tool.</p> |
There was a problem hiding this comment.
nit: KAFKA-19026 -> KAFKA-19480
There was a problem hiding this comment.
apache/kafka-site#708 has the same issue. I will file a minor to fix it
There was a problem hiding this comment.
@chia7712 thanks and sorry, that slipped through me..
There was a problem hiding this comment.
don't worry 😄
we will file a PR to fix both repos
chia7712
pushed a commit
that referenced
this pull request
Oct 10, 2025
see #20627 (comment) This pull request corrects a typo in the documentation by updating the JIRA link from KAFKA-19026 to KAFKA-19480 in the ops.html file. Reviewers: Chia-Ping Tsai <[email protected]>
chia7712
pushed a commit
to apache/kafka-site
that referenced
this pull request
Oct 13, 2025
see apache/kafka#20627 (comment) This pull request corrects a typo in the documentation by updating the JIRA link from KAFKA-19026 to KAFKA-19480 in the ops.html file. Reviewers: Chia-Ping Tsai [email protected]
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
When using the zookeeper-security-migration tool without the '–enable.path.check' option, the script not only updates the ACLs for the existing znodes, but also creates any non-existing ones (with the ACL options specified) using null values based on the list defined in ZkData.SecureRootPaths. This is especially problematic for the /migration znode as the current logic only checks for the existence of the znode and later the migration process will hang when it tries to parse the null value over and over again.
In summary, the migration cannot be completed if the zookeeper-security-migration script was run previously, and the only workaround is to manually remove the /migration znode in such cases. I propose a simple fix to circumvent the manual step by recreating the /migration znode if it contains a null value.